home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / cheev.z / cheev
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCHHHHEEEEEEEEVVVV((((3333FFFF))))                                                            CCCCHHHHEEEEEEEEVVVV((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CHEEV - compute all eigenvalues and, optionally, eigenvectors of a
  10.      complex Hermitian matrix A
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE CHEEV( JOBZ, UPLO, N, A, LDA, W, WORK, LWORK, RWORK, INFO )
  14.  
  15.          CHARACTER     JOBZ, UPLO
  16.  
  17.          INTEGER       INFO, LDA, LWORK, N
  18.  
  19.          REAL          RWORK( * ), W( * )
  20.  
  21.          COMPLEX       A( LDA, * ), WORK( * )
  22.  
  23. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  24.      CHEEV computes all eigenvalues and, optionally, eigenvectors of a complex
  25.      Hermitian matrix A.
  26.  
  27.  
  28. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  29.      JOBZ    (input) CHARACTER*1
  30.              = 'N':  Compute eigenvalues only;
  31.              = 'V':  Compute eigenvalues and eigenvectors.
  32.  
  33.      UPLO    (input) CHARACTER*1
  34.              = 'U':  Upper triangle of A is stored;
  35.              = 'L':  Lower triangle of A is stored.
  36.  
  37.      N       (input) INTEGER
  38.              The order of the matrix A.  N >= 0.
  39.  
  40.      A       (input/output) COMPLEX array, dimension (LDA, N)
  41.              On entry, the Hermitian matrix A.  If UPLO = 'U', the leading N-
  42.              by-N upper triangular part of A contains the upper triangular
  43.              part of the matrix A.  If UPLO = 'L', the leading N-by-N lower
  44.              triangular part of A contains the lower triangular part of the
  45.              matrix A.  On exit, if JOBZ = 'V', then if INFO = 0, A contains
  46.              the orthonormal eigenvectors of the matrix A.  If JOBZ = 'N',
  47.              then on exit the lower triangle (if UPLO='L') or the upper
  48.              triangle (if UPLO='U') of A, including the diagonal, is
  49.              destroyed.
  50.  
  51.      LDA     (input) INTEGER
  52.              The leading dimension of the array A.  LDA >= max(1,N).
  53.  
  54.      W       (output) REAL array, dimension (N)
  55.              If INFO = 0, the eigenvalues in ascending order.
  56.  
  57.      WORK    (workspace/output) COMPLEX array, dimension (LWORK)
  58.              On exit, if INFO = 0, WORK(1) returns the optimal LWORK.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCHHHHEEEEEEEEVVVV((((3333FFFF))))                                                            CCCCHHHHEEEEEEEEVVVV((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      LWORK   (input) INTEGER
  75.              The length of the array WORK.  LWORK >= max(1,2*N-1).  For
  76.              optimal efficiency, LWORK >= (NB+1)*N, where NB is the blocksize
  77.              for CHETRD returned by ILAENV.
  78.  
  79.      RWORK   (workspace) REAL array, dimension (max(1, 3*N-2))
  80.  
  81.      INFO    (output) INTEGER
  82.              = 0:  successful exit
  83.              < 0:  if INFO = -i, the i-th argument had an illegal value
  84.              > 0:  if INFO = i, the algorithm failed to converge; i off-
  85.              diagonal elements of an intermediate tridiagonal form did not
  86.              converge to zero.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.